Used colors should have more straightforward names and contrast

[gisostallenberg]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties

What specific section or headline is this issue about?

No response

What information was incorrect, unhelpful, or incomplete?

The colors used in the examples are kinds of blue, but I'm not really familiar with the specific color names. The example with green is easier to understand.

What did you expect to see?

That from reading the code samples I can understand the rendered content better.

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/css/css_cascading_variables/using_css_custom_properties
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/css/css_cascading_variables/using_css_custom_properties/index.md
• Last commit: e9b6cd1
• Document last modified: 2025-04-10T14:56:07.000Z

[Josh-Cena]

These are code entities. You should understand them as code, not as English; even a programmer who does not understand a word of English should be able to read and produce code like this.

[gisostallenberg]

@Josh-Cena I do understand this fact.
I meant that visually understanding the documentation (rendered output) is way harder if you'd have to understand the color word when it is not clearly a distinct color by the wording. Especially because this article explains inheritance.

An example:

[Josh-Cena]

OK, I agree. Let's seek to change the colors, maybe to two with completely different hues.